API(應用程式介面,Application Programming Interface)是一組定義了應用程式或服務之間如何相互溝通的規則和協議。它提供了一種標準化的方式,使不同軟體系統之間可以交換數據或使用彼此的功能。
API 的作用通常包括:
舉個例子🌰
當一個應用程式通過 API 向另一個服務請求資料時,API 會規定這個請求的格式(如 HTTP 請求的結構)、需要哪些參數,以及如何處理返回的數據。
在 Odoo 等企業資源規劃系統中,API 可能被用來與其他系統(例如 CRM、會計系統、電子商務平台)集成,實現自動化工作流等功能。
直接這樣講有點抽象 用實際收穫舉例一下吧~
我、銀行網路服務(API)、銀行系統
當你在網上進行轉帳或查詢賬戶餘額時,你會通過銀行的網路服務(API)操作,而不是直接與銀行的內部系統溝通。你輸入轉帳金額或查詢請求,網路服務(API)會將這些請求轉交給銀行的內部系統,該系統處理請求並返回結果。銀行的網路服務(API)就像中介,使得你可以輕鬆地進行銀行業務,而不需直接了解銀行系統的詳細運作。
WebAPI 和 OpenAPI 是兩種與 API 相關的重要概念,但它們的用途和範疇有所不同:
WebAPI 是指通過網路(通常是 HTTP 協議)提供的 API。它使得不同的應用程式可以通過互聯網進行交互。WebAPI 的主要特點包括:
範例:許多現代應用程式(如社交媒體、地圖服務等)都提供 WebAPI,讓開發者可以通過 HTTP 請求獲取資料或操作服務。
OpenAPI(以前稱為 Swagger)是一種用於描述和定義 WebAPI 的標準。它提供了一種標準化的方式來描述 API 的結構、功能和操作,從而使得 API 的使用、理解和測試變得更加容易。OpenAPI 的主要特點包括:
範例:如果使用 OpenAPI 描述一個 WebAPI,可以通過生成的文檔自動了解如何調用這個 API,並且可以使用自動生成的代碼快速構建應用程序。
,WebAPI 是實際的接口,用於提供功能或數據,而 OpenAPI 是描述這些接口的標準,使得 API 更易於理解和使用。